home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 8 / Mac Magazin and MacEasy Magazine CD - Issue 08.iso / Sharewarebibliothek / Utilities / ∆î 0.9ß5ƒ / ∆î Documentation < prev   
Text File  |  1994-10-26  |  7KB  |  108 lines
  1. Δî (Delta Image) 0.9.ß5
  2. © 1994 Sean Turrell.  All rights reserved.
  3.  
  4. This program is not to be distributed on Compact Disks, but any other form of non-commercial/not-for-profit distribution is allowed.
  5.  
  6. Introduction
  7.  
  8. This program converts DiskCopy, DART, and Norton Floppier images to DiskDup+ images.  Delta Image will also rename DiskDup+ images using the floppy disk's name according the filename conventions listed below.
  9.  
  10. To convert/rename image(s), simple drop them (or Folders/Volumes) onto Δî.
  11.  
  12. To delete (successfully converted) source images (DiskCopy or Dart) hold down the option key when droping them onto Δî.
  13.  
  14. To zero unused sectors (aka allocation blocks) of DiskDup+ images (including any that were converted to DiskDup+ format) hold down the command key when droping them onto Δî.
  15.  
  16. Purpose:
  17.  
  18. To efficiently convert all known forms of 800K and 1440K Mac disk images into DiskDup+ images.  For standard macintosh disks DiskDup+ images have three main advantages over the other image file types, and only one (removable) disadvantage.
  19.  
  20. 1) size -  images are exactly 800K or 1440K since they are,
  21. 2) uncompressed** and contain no "physical" disk data or checksums.
  22. 3) Efficiently/Speed when mounting , reading, or writing  images  with DiskDup+, whose driver and interface are the best and most reliable -- particularily with respect to working correctly with the various installers.
  23. 4) The fact that there are no checksums present in a DiskDup+ image is not really a disadvantage, since disk images are used mainly as a backup device and are usually stored in a compressed form -- and any decent compression program will implement rigorous checksumming techniques to insure data integrity.
  24.  
  25. ** Building custom compression into images is just stupid since most (if not any) given image will undoubtedly compress faster and better by using a dedicated stand-alone compression product, such as Alladin's Stuffit™.
  26.  
  27. The "zero unused sectors" option simply overwrites unused areas of the disk (according to the volume bit map) with zero bytes.  This helps to insure that a given image (especially images of disks that have a lot of free space) will compress as tightly and as quickly as possible for any given compression scheme, since it has the effect of reducing the overall complexity of the data to be compressed by making it less variable and more persistant. (ie replacing what may be "near random" data with relatively long runs of a single byte pattern - zero in this case)
  28.  
  29. Filename Conventions.
  30.  
  31. All DiskDup+ files created or renamed will be named "<PhysicalDiskName>.î"  Unless a file with this name is already present, in which case a number "<N>" is added, where 1≤N≤9.
  32.  
  33. If all 10 of these names are already in use (in the source files directory) then the file is skipped.
  34.  
  35. Hints & Tips
  36.  
  37.  Δî only works with System 7 or greater.
  38.  
  39. Can usefully use only 1420K more than it's  Get Info suggested size. 
  40.  
  41. It can crash and/or will not run if given less memory than it's Get Info suggested size.
  42.  
  43. There are currently no error messages, but all possible error conditions are checked (hopefully) and it should not crash. (if it crashes on a DART™ see below)
  44.  
  45. If an error occurs it will beep (once and only once per file) and skip that file.
  46.  
  47. Limitations/Warnings/Known Problems
  48.  
  49. Version 0.9.ß1 was written in less than a day…
  50.  
  51. I can only manage to get the finder to update the contents of the parent directory of the items being dragged, so you will have to close and re-open any open nested directories to update the finder display. (ie to see the new filenames after renaming DiskDup+ images)
  52.  
  53. The "zero unused sectors" option only works for HFS disks.
  54.  
  55. If it crashes while processing a (valid) DART™ image you can try giving Δî (1420+x)K more than it's  Get Info suggested size - this will leave (64+x)K of heap memory unused by any of my code and may help the dart code as it seems to require (undocumentedly) a lot of extra memory.  I've increased the stack to 32K and always leave 64K of heap space in reserve just to insure the DART™ decompression code works.  It hasn't crashed on me since I did this...
  56.  
  57. Δî is a complete system hog and does not work in the background for these FUNCTIONALITY beta releases.
  58.  
  59. Δî is dog slow when converting DART™ images, this is entirely due to the decompression routines. (for which I do not have the source code or specific details of -- which would allow me to  improve or at least write a PowerPC native version).
  60.  
  61. Distribution
  62.  
  63. The Δî application is free.
  64.  
  65. Some of the compiled source (namely DartIntf.h,  and DartIntf.o) are copyright Apple Computer, Inc. 
  66.  
  67. Credits
  68.  
  69. Δî was written by Sean Turrell.
  70.  
  71. The DART file format and decompression routines were leeched of the Internet where they were provided (I presume) by Ken McLeod (one of it's authors at Apple Computer).
  72.  
  73. I can be reached on the internet through <chris.kohuch@sunshine.net>
  74.  
  75. Requests for Information
  76.  
  77. If you have any other useful source code or the file formats/decompression info on DART, MacTools, or other disk images please send it to the above internet address and I will (probably) incorporate it.
  78.  
  79. MacTools images seem to have a $200 byte header involving some fields from the VIB and the VBM, but I know little of it's structure.
  80.  
  81. Version History
  82. 0.9.1 — 94/?/?  Release Version: (Hypothetical - DNE yet) If and/when I get around to it I will:
  83. •Add the ability to convert (uncompressed) MacTools™ CP FastCopy images as well.
  84. •Add a progress indicator and perhaps a prefs interface -- trying to avoid this for now.
  85. •Add the ability to stop/pause converting images...
  86. •Compile it Fat -- I have yet to get CodeWarrior - but it <should> compile with 10 minutes work.
  87. •Add real error messages - check that volumes I want to write to are not locked rather than error, ect...
  88. •consider checking/verifying the checksum info of the original files before converting.
  89.  
  90. 0.9.ß5 — 94/10/26
  91. •now converts Norton™ Floppier images as well. (uncompressed CP FastCopy Images will be next)
  92. •fixes bug that would erroneously cause an error beep sound to play for each non image file when the zeroing of unused sectors was selected.  (exact same problem as in ß2, so I put all the image postprocessing code inside one conditional now to insure this error never occurs again no matter how many more things I add)
  93.  
  94. 0.9.ß4 — 94/10/21
  95. •added the optional  ability to zero unused disk sectors (DiskDup+ images only)
  96. •the delete old option will no longer cause images to be skipped during conversion.
  97.  
  98. 0.9.ß3 — 94/10/07 (not released)
  99. •now converts compressed (and compressed SEA) DiskCopy 6.x images as well.
  100.  
  101. 0.9.ß2 — 94/09/09
  102. •updates the finder to changes within the directory containing the dragged items, but still cannot find a method (short of restarting the finder) to update open nested directories.
  103. •fixes bug that would erroneously cause an error beep sound to play for each non (DiskCopy or Dart) image file when the deleting of old images was selected.
  104.  
  105. 0.9.ß1 — 94/09/03 
  106. •1st Beta version (funcationality beta - no interface or backgroundability)
  107.  
  108.